Wolters Kluwer CCH® SureTax®

    Show / Hide Table of Contents

    Investigator API

    POST Search TaxMatrix By PGPI

    POST Search TaxMatrix By PGPI

    Overview

    Performs a pgpi operation.

    OperationId: POST Search TaxMatrix By PGPI

    Authorization Method(s): OAuth

    Verb: POST

    End Point: /api/taxmatrix/search/pgpi


    Request Body
    Request Model
    Display NameField NameField Type
    Client Number *clientNumberstring
    Search Country searchCountrySearchCountry
    Search Option searchOptionSearchOption
    Search Type searchTypestring
    Filters filtersTaxMatrixSearchFilters
    Parameters parametersCommonSearchParameters
    SearchCountry
    Display NameField NameField Type
    SearchOption
    Display NameField NameField Type
    TaxMatrixSearchFilters
    Display NameField NameField Type
    Customer Usage Type *customerUsageTypestring
    Provider Type *providerTypeproviderTypes
    As Of Date asOfDateDataYearMonth
    Release Number releaseNumberinteger
    Date Type dateTypeSearchDateType
    DataYearMonth
    Display NameField NameField Type
    Year *yearstring
    Month *monthstring
    Day dayinteger
    SearchDateType
    Display NameField NameField Type
    CommonSearchParameters
    Display NameField NameField Type
    Pgpis pgpisarray[Pgpi]
    Postal Code postalCodestring
    Npanxx npanxxstring
    Locations locationsarray[]
    Address addressAddress
    State County City stateCountyCityStateCountyCity
    Geocode geocodestring
    By bySearchListItemsBy
    Skus skusarray[]
    Pgpi
    Display NameField NameField Type
    Product Group productGroupstring
    Product Item productItemstring
    Address
    Display NameField NameField Type
    Address1 address1string
    Address2 address2string
    City citystring
    County countystring
    Postal Code postalCodestring
    Plus4 plus4string
    State statestring
    StateCountyCity
    Display NameField NameField Type
    State *statestring
    County countystring
    City citystring
    SearchListItemsBy
    Display NameField NameField Type

    Example Request

    The following is an json request for this operation.

    {
      "filters": {
        "customerUsageType": "07",
        "providerType": "80",
        "asOfDate": {
          "year": "2024",
          "month": "12",
          "day": 1
        },
        "releaseNumber": null,
        "dateType": "Date"
      },
      "parameters": {
        "pgpis": [
          {
            "productGroup": "1111",
            "productItem": "55"
          }
        ],
        "postalCode": null,
        "npanxx": null,
        "locations": null,
        "address": null,
        "stateCountyCity": null,
        "geocode": "US48113A0004",
        "by": "ProductGroupItem",
        "skus": []
      },
      "clientNumber": "ZRERT1234",
      "searchCountry": "UnitedStates",
      "searchOption": "PostalCode",
      "searchType": "TaxabilityMatrix"
    }

    Query Parameters
    Query parameters in an API operation are key-value pairs that are included in the URL of an API request to filter or modify the data returned by the API. They come after the `?` in the URL and are often used to pass optional parameters like search terms, pagination information, sorting criteria, or filters to narrow down the data in the response.

    Display String Field Name Field Type
    Api-version* api-version undefined

    *Mandatory parameter

    ProblemDetails

    Overview

    ProblemDetails
    Display NameField NameField Type
    Type typestring
    Title titlestring
    Status statusinteger
    Detail detailstring
    Instance instancestring

    Example Response

    The following is an example response you can expect for this operation

    {
      "pgpiResult": [
        {
          "productGroups": [
            {
              "group": "0111",
              "groupDescription": "ALCOHOLIC BEVERAGES-GROCERY",
              "items": [
                {
                  "item": "006",
                  "itemDescription": "READY TO DRINK COCKTAILS"
                }
              ]
            }
          ]
        }
      ]
    }
    Response Codes
    Response codes in an API indicate the outcome of a request. They are three-digit numbers returned by the server to help the client understand if the request was successful, encountered an error, or needs further action. This operation has the following possible responses.

    code description
    200 Returns the result of the pgpi operation.
    400 Invalid request to call the API.
    401 User is not authorized to access the API.




    Enter Environment Credentials








    Wolters Kluwer Product Name - Page anchor links toWolters Kluwer Product Name - Page anchor links to
    © Wolters Kluwer and/or its affiliates. All rights reserved.